home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 18 / CU Amiga Magazine's Super CD-ROM 18 (1997)(EMAP Images)(GB)[!][issue 1998-01].iso / CUCD / Online / hsc / docs-source / macro / flag.hsc < prev    next >
Encoding:
Text File  |  1997-06-02  |  3.4 KB  |  83 lines
  1. <WEBPAGE chapter="hsc - Features - Macros - "
  2.          PREV="macros.html"
  3.          NEXT="attrib.html"
  4.          title="Modifiers For Tag- And Macro Declarations">
  5.  
  6. <$macro LIFLAG SHORT:string/r LONG:string/r ONLYDEFTAG:bool>
  7. <DT><CODE>/<(long)></CODE>
  8.     (short: <CODE>/<(short)></CODE>)
  9. <DD>
  10. </$macro>
  11.  
  12. <P>Within  <ln_macro> and <ln_deftag>,
  13. you can use several modifiers to tell <hsc> how to handle this macro/tag.</P>
  14.  
  15.  
  16. Allowed modifiers for both <ln_macro> and <ln_deftag> are:
  17. <DL>
  18. <LIFLAG long="CLOSE" short="C">
  19.     macro/tag is a container and requires a corresponding end tag.
  20.  
  21. <LIFLAG long="ONLYONCE" short="1">
  22.     macro/tag is required at the most once within a document
  23.  
  24. <LIFLAG long="REQUIRED" short="R">
  25.     macro/tag is required to appear at least once within a document
  26.  
  27. <LIFLAG long="RECOMMENDED" short="RCMD">
  28.     macro/tag ought to appear least once within a document
  29.  
  30. <LIFLAG long="MUST_BE_INSIDE" short="MBI">
  31.     Needs a string as argument, that contains a list of container tags,
  32.     that must be started before tag is allowed to be used.<BR>
  33.     Example:<BR>
  34.     The tag <TG>LI</TG> must be used inside some sort of lists only,
  35.     therefor it's <CODE>/MBI="ul|ol|dir|menu"</CODE> is used.
  36.     The <vbar> is used as a separator for multiple tags.
  37.  
  38. <LIFLAG long="NOT_ALLOWED_WITHIN" short="NAW">
  39.     Like <CODE>/MBI</CODE>, but this time tags that must not be
  40.     used before. For example, a nested usage of <TG>A</TG>
  41.     is not allowed, therefor <CODE>/NAW="a"</CODE> is used.
  42. </DL>
  43.  
  44. Additionally, the following modifiers can be used with <ln_deftag>
  45. <DL>
  46. <LIFLAG long="AUTOCLOSE" short="AC">
  47.     Used for <TG>P</TG> and <TG>LI</TG>, which can be used as container
  48.     or single tag depending on the HTML version. Tags marked with this
  49.     modifier can not be nested.
  50. <LIFLAG long="JERK" short="J" ONLYDEFTAG>
  51.     tag is only used by jerks
  52. <LIFLAG long="LAZY" short="L" ONLYDEFTAG>
  53.     This modifier has just been for my laziness and defines some
  54.     often needed attributes with a single letter;
  55.     <qq><CODE>c</CODE></qq> for <qq><CODE>CLASS:string</CODE></qq>,
  56.     <qq><CODE>h</CODE></qq> for <qq><CODE>HREF:uri</CODE></qq>,
  57.     <qq><CODE>i</CODE></qq> for <qq><CODE>ID:id</CODE></qq>,
  58.     <qq><CODE>k</CODE></qq> for <qq><CODE>CLEAR:bool</CODE></qq>,
  59.     <qq><CODE>l</CODE></qq> for <qq><CODE>LANG:string</CODE></qq>,
  60.     <qq><CODE>m</CODE></qq> for <qq><CODE>MD:string</CODE></qq>,
  61.     <qq><CODE>s</CODE></qq> for <qq><CODE>SRC:uri</CODE></qq>,
  62.     <qq><CODE>w</CODE></qq> for <qq><CODE>NOWRAP:bool</CODE></qq>.<BR>
  63.     For example, use <CODE>/LAZY="cil"</CODE>.
  64. <LIFLAG long="OBSOLETE" short="O">
  65.     tag is obsolete and should not be used any more. This eg.
  66.     concerns <TG>LISTING</TG>.
  67. <LIFLAG long="SKIPLF" short="S">
  68.     skip a linefeed ("\n") that comes immediately after the tag. This
  69.     is only useful for some of <hsc>'s special tags and only avoids
  70.     some unnecessary empty lines.
  71. <LIFLAG long="SPECIAL" short="SPC">
  72.     This one marks tags which are no normal tags with some attributes,
  73.     but have their own syntax. The only html tag which has this modifier
  74.     set is <TG>!</TG> (for SGML comments).
  75. <LIFLAG long="WHTSPC" short="W">
  76.     If this modifier is set, any occurrence of the container is checked
  77.     for succeeding/preceding white spaces. By default, this concerns
  78.     the tags <TG>A</TG>, <TG>TITLE</TG>, headings and physical/logical
  79.     styles like <TG>B</TG> or <TG>strong</TG>.
  80. </DL>
  81.  
  82. </WEBPAGE>
  83.